About:config entries

From MozillaZine Knowledge Base
Revision as of 16:27, 16 July 2004 by Polidobj (talk | contribs) (updated view_source. wrap_long_lines)
Jump to navigationJump to search

about:config is a list of preferences that you can change. This article is meant to be a partial documentation of those preferences. For more information on how to use about:config, [1].

Note that many of the entries that appear in Firefox will also apply to Mozilla and vice versa.

Note: spaces between the dots in preference names exist purely for word-wrapping. They are actually not present and should not be thought as so.

Accessibility.*

Name Type Meaning of Values
accessibility. browsewithcaret Boolean True: A caret is present in the browser window to use to select text with the keyboard.

False: No caret is present.
This can be toggled using the F7 key.

accessibility. tabfocus Integer Determines which web page elements can gain focus when TAB key is pressed.

1: Text field form controls only
2: All form controls except text fields
3: All form controls
4: Hyperlinks and hyperlinked images
7 : All form controls and hyperlinks

accessibility. typeaheadfind. autostart Boolean True: Type Ahead Find will start automatically when typing starts and a form control like a text area or text box does not have focus.

False: Type Ahead find will only start when / is pressed for any word and when ' is pressed for link searching.

accessibility. typeaheadfind. enablesound Boolean True: Type Ahead Find will play a sound when the typed in search phrase is not found.

False: Type Ahead Find will not play any sounds.

accessibility. typeaheadfind. enabletimeout Boolean True: A Type Ahead Find will end after a set time if no keys are pressed.

False: A Type Ahead Find will not end due to a timeout. To end a search use the escape key.

accessibility. typeaheadfind. linksonly Boolean True: Find As You Type will only search links.

False: Find As You Type will search all the text.
Note: in Firefox, this can be changed via Tools > Options > Accessibility > Find As You Type

accessibility. typeaheadfind. soundURL String Specify filename (.wav) for the error sound, or use "default" for default sound or "beep" for system beep.
accessibility. typeaheadfind. startlinksonly Boolean True: When finding links, the search will only match links from the beginning of the link's text.

False: The search will match any part of a link's text.

accessibility. typeaheadfind. timeout Integer The number of milliseconds that a Type Ahead Find will wait between key presses before ending an active search.
accessibility. warn_on_browsewithcaret Boolean True: You will be promted to comfirm enabling caret browsing.

False: The opposite of above.

Browser.*

Name Type Meaning of Values
browser. blink_allowed Boolean True: Use of the blink tag or CSS's text-decoration: blink will result in blinking elements.

False: Blinking is disabled.

browser. block. target_new_window Boolean True: Links with target set to _blank will open in the current tab instead of a new window.

False: Links with target set to _blank will open in a new window.

browser.bookmarks.file String The full path and filename of your bookmarks file (bookmarks.html).
browser. chrome. favicons

--OR--
browser. chrome. site_icons

Boolean True: favicons/site icons will be visible, cached, etc.

False: favicons/site icons will be not visibile, cached, etc.

browser. display. background_color String Sets the default background color for browser tabs. This affects blank tabs, web pages whose background's are not explicity set and xul error pages. (#RRGGBB)
browser. display. focus_ring_width Integer 0: dots around focused links will not be displayed.

1: dots around focused links will be displayed.

browser. download. manager. showAlertOnComplete Boolean True: popup window at bottom right corner of the screen will appear once all downloads are finished.

False: the popup window will not appear.

browser. enable_automatic_image_resizing Boolean True: When viewing an image not in a web page, the image will be resized to fit in the browser window if it is too large for the browser window. The image can be shown in its real size by left clicking on it.

False: Images are always shown in their real size.
Note: In Firefox, this can be changed via Tools > Options > Advanced > Multimedia > Resize large images to fit in the browser window.

browser. popups. showPopupBlocker Boolean True: Show an incon in the status bar when a popup has been blocked.

False: Do not show an icon in the status bar when a popup has been blocked.

browser. tabs. loadBookmarksInBackground Boolean True: When you open a bookmark in a new tab then that tab will load in the background without taking focus from the current tab.

False: When you open a bookmark in a new tab then that tab will become the current tab.

browser. tabs. loadFolderAndReplace Boolean True: When opening a folder of bookmarks in tabs, the existing tabs will be replaced by the new bookmark pages.

False: Existing tabs will be preserved when loading a folder of bookmarks. The bookmark pages will be loaded in tabs that are appended to the current tabs.

browser. tabs. loadOnNewTab Integer Set what should be displayed in a newly created tab

-1: Browser Startup Page
0: Blank Page
1: Your Homepage
2: Last Visited

browser.tabs.opentabfor.middleclick Boolean Controls if a link will open in a new tab when middle-clicked. Otherwise, it will open in a new window. If true, middle-clicking a link opens it in a new tab. If false, the link will open in a new window.
browser. tabs. warnOnClose Boolean True: The broswer will prompt for confirmation when closing the browser when more than one tab is open.

False: No warnings will be given when closing the browser with more thanone tab.

browser. throbber. url String Indicates what URL to load when the throbber is clicked.
browser. urlbar. clickSelectsAll Boolean True: Select the contents of the address bar when it is clicked.

False: Opposite of Above.

browser. windows. loadOnNewWindow Integer Set what should be displayed in a newly created window

-1: Browser Startup Page
0: Blank Page
1: Your Homepage
2: Last Visited

browser. xul. error_pages. enabled Boolean True: The browser will use error pages.

False: The browser will use error alert boxes.

DOM.*

Name Type Meaning of Values
dom.disable_window_open_feature.* Boolean Web Page authors can disable many features of a popup window that they open. Setting these preferences to true will override the author's settings and ensure that that feature is enabled and present in any popup window.

Close : Prevents the close button from being disabled.
Directories: Prevents the bookmarks toolbar from being hidden.
Location: Prevents the address bar from being hidden
Menu Bar: Prevents the menubar from being hidden.
Minimizable: Prevents popup window minimization from being disabled.
Personal Bar: Prevents the bookmarks toolbar from being hidden.
Resizable: Prevents popup window resizing from being disabled.
Scrollbars: Prevents the scrollbars on a popup from being disabled.
Status: Prevents the status bar from being hidden.
Title Bar: Prevents the title bar from being hidden.
Toolbar: Prevents the navigation toolbar from being hidden.

dom. event. contextmenu. enabled Boolean True: the opposite of below.

False: webpages will not be able to disturb the right-click mouse event, thus allowing to access the context menu all the time.
Note: in Firefox, this can be changed via Tools menu > Options menu item > Web Features panel > Advanced buton > Disable or replace context menus checkbox.

Middlemouse.*

Name Type Meaning of Values
middlemouse.contentLoadURL Boolean By default, this is true on Linux and false on all other OSes. If this is set to true, it will override middle-clicking tabs to close them.
True: Firefox will go to whatever is currently in your clipboard.
False: Firefox will never do the aforementioned when you middle click.
middlemouse.openNewWindow Boolean Despite what the preference name obviously suggests, this doesn't seem to control whether middle-clicking a link opens a new window or not.
middlemouse.paste Boolean By default, this is true on Linux and false on all other OSes. This only applies when you have focus is a text field or area.
True: Middle-clicking a text field or area will paste whatever is in your clipboard into the text field or area.
False: It will not.

Network.*

Name Type Meaning of Values
network.http.redirection-limit Integer This number will limit how many consecutive HTTP redirects Firefox can do. The default number is "20". Setting it to "0" will stop all redirects from occuring.

Miscellaneous

Name Type Meaning of Values
allinonegest. /et cetera/ Varied These preferences are set via the All in One Mouse Gestures extension.
application. use_ns_plugin_finder Boolean True: When a plugin is not found, clicking on the puzzle piece will open a dialog telling the user what plugin is needed. Clicking on the 'Get the Plugin' button brings the user to the plugins installation page.

False: Clicking on the puzzle piece will send the user to that plugin's page on plugins.netscape.com which will have a link to that plugin's installation page..

extension. * Varied These entries are added by extensions. Most extension preferences can be edited using that extension's options dialog. Extension option dialogs are accessed using the extension manger. Not all extension options start with the extension keyword.
image. animation_mode String None: animated images will never play.

Once: animated images will play once.
Normal: animated images will play as normal.

layout. frames. force_resizability Boolean True: All frames will be resizable resulting in a movable separator between frames.

False: The resizability of frames is determined by the web page.

view_source. wrap_long_lines Boolean True: HTML code will wrap in the view source window.

False: HTML code will not wrap in the view source window.
Note: This can be changed using View->Wrap Long Lines in the view source window.