I downloaded the JavaFx source code from http://hg.openjdk.java.net/openjfx/2.2/master/rt/summary.
The name of the folder in the zip file is re-e71070b0e0c0
These instructions are only necessary for the JavaFX 2.x branch and will be obsoleted once JDK 8 is released.
After you have downloaded the source zip and extracted it, open Idea and follow these instructions:
Modify the source structure for your 1.7 SDK:
File | Project Structure | SDKs | Sourcepath
For each sub-project in the extracted zip, type Alt+Insert and add the respective source directory. For example rt-e71070b0e0c0\javafx-ui-charts\src, rt-e71070b0e0c0\javafx-ui-common\src, etc. Not all JavaFX 2.x source code is currently open sourced, so this will only add the open sourced portions.
Set the documentation lookup path:
File | Project Structure | SDKs | Documentation Paths
Specify a url Alt+S for the documentation: http://docs.oracle.com/javafx/2/api/
In your JavaFX application source, place your cursor over a JavaFX class usage, for instance LineChart:
Update Oct 16 2013
JDK 8 now includes JavaFX source files.
To tell Idea where JavaFX sources are:
Modify the source structure for your 1.8 SDK:
File | Project Structure | SDKs | Sourcepath
Press Alt+S to add the file javafx-src.zip, which is located in the root directory of the JDK 8 distribution.
Set the documentation lookup path:
File | Project Structure | SDKs | Documentation Paths
Specify a url Alt+S for the documentation: http://download.java.net/jdk8/jfxdocs.
The JDK 8 JavaFX documentation url will likely change when JDK 8 reaches General Availability release stage.
Step 3 above provides keyboard shortcuts to quickly access the JavaFX sources and documentation from your project.