FLUID-329: Update lightbox instructions that describe keyboard interaction for be more clear

Description

We should update the instructions to do 2 things:

• Make keyboard interactions clear for how to select and see a full view of the image along with how "drag and drop" work. It currently says, "View an image by pressing Enter. Move an image using CTRL+Arrow Key." We want to keep it brief but it seems to need a little something more for clarity.
• Either include mouse instructions too or be clear that instructions only refer to keyboard interactions – something like "To use the keyboard to reorder thumbnails...."

Comments

• Anastasia Cheetham commented 2008-04-10T14:27:44.000-0400

  Daphne, here is the suggested improvement:

  To use the keyboard:
  Select an image using i, k, m or j, or the arrow keys.
  View an image by pressing Enter.
  Move an image using CTRL + a direction key.

  (Note that the Lightbox now includes, by default, two different key sets (and can therefore be used with a screen reader)).

  If this seems good to you, I'll make the change - let me know.

• Daphne Ogle commented 2008-04-14T19:20:58.000-0400

  This sounds good to me. Thanks Anastasia!

• Anastasia Cheetham commented 2008-04-15T09:58:14.000-0400

  The instructions have been updated. Daphne, I've updated the demo on the build site:

  http://build.fluidproject.org/sakai-imagegallery-tool/fluid-components/html/Lightbox.html

  If it looks fine to you, you can close this one.

• Daphne Ogle commented 2008-04-15T12:40:20.000-0400

  One question, are there other directional keys besides the arrow keys? I ask because we use both terms in the instructions. If they mean the same thing, we should probably use one term or the other. I'm guessing there may be other directional keys on special keyboards but just wanted to check.

• Anastasia Cheetham commented 2008-04-15T12:59:13.000-0400

  Yes, there are other directional keys besides the arrow keys. As the instructions say, you can use the i, k, m and j keys instead of the arrow keys. Either should work, both should work. I just tried the demo file, and it all works as expected.

  You also mentioned that once a user 'opens' an image, the only way to get back is via the browser's back button - yes, this is the way the Lightbox works.

• Daphne Ogle commented 2008-04-15T14:19:11.000-0400

  Ah ha, I figured out my confusion. I was reading the I as a L. I'm not sure how to alleviate that potential confusion since using capitals might give users the expectation they have to use caps. What do you think? I'll close this for now and assume it will be caught in the user testing Mike is doing if it proves to be problem outside of my aging eyes.

• Jonathan Hung commented 2008-05-15T10:59:12.000-0400

  Current instructions state:

  "To use the keyboard:
  Select an image using i, k, m or j, or the arrow keys.
  View an image by pressing Enter.
  Move an image using CTRL + a direction key."

  But it isn't clear what is referred to by "a direction key". Is this an arrow key? i-k-m-j? Both?

• Michelle D'Souza commented 2008-05-27T16:52:24.000-0400

  We are going to leave it the way it is and find out if we need to refine based on user testing.