Dawlat Al Islam Qamat Nasheed Link Review
The phrase "Dawlat al Islam Qamat" (The Islamic State Has Risen) refers to a notorious nasheed (Islamic vocal chant) titled "Qamat Dawlat al-Islam" (also known as Ummati Qad Laha Fajrun).
This nasheed became widely known globally as the unofficial anthem of the terrorist organization ISIS (Daesh). It was frequently used in their propaganda videos starting around 2014.
| Aspect | Details |
|--------|---------|
| Founding | Formed in 2017 by a trio of Saudi‑Arabian musicians and poets who wanted to bridge the gap between classic nasheed styles and contemporary production. |
| Mission | “To spread the message of Islam through melody, poetry, and high‑quality audio‑visual content while respecting the traditions of halal music.” |
| Key Members | • Ahmed Al‑Mansour – lead vocalist & lyricist
• Sami Al‑Haddad – music arranger & composer
• Layla Al‑Fahad – vocal harmonies & video direction |
| Signature Sound | A blend of taqsim (instrumental improvisation) on oud or qanun, layered choral vocals, and subtle percussive elements such as daff and riq. The group avoids stringed instruments that are traditionally considered non‑permissible in some Islamic circles, opting instead for digital orchestration that mimics the timbre of those instruments. |
“Dawlat al‑Islam qāmat” (Arabic: دولة الإسلام قامت) translates to “The Islamic State has risen”. The phrase is widely used in contemporary Islamic discourse, political rhetoric, and artistic expressions (especially nasheeds) to convey the belief that a genuine, just, and sovereign Islamic governance is either emerging or ought to emerge. This report explores the historical, theological, political, and cultural dimensions of the concept, and suggests a nasheed that captures its spirit.
“Qamat” exemplifies how contemporary Islamic artists can harness modern production values while staying true to the spiritual and ethical framework of nasheed tradition. Dawlat Al‑Islam’s careful balance of halal instrumentation, powerful lyrical messaging, and high‑quality visual storytelling has resonated with a global audience, making the track a modern anthem for youthful awakening and collective responsibility.
The nasheed you are referring to, "Dawlat al-Islam Qamat" (The Islamic State has been established), is also widely known by its first line, "Ummati Qad Laha Fajrun" (My Ummah, Dawn Has Appeared).
Released in late 2013 by the Ajnad Media Foundation, it became an unofficial anthem associated with the Islamic State. Access & Listening
Due to its association with extremist organizations, this content is frequently removed from mainstream platforms. However, archived or re-uploaded versions can sometimes be found on: Audiomack: Dawlat al Islam Qamat.
CBC Player: A short 1:11 version is available on the CBC Radio Player.
Spotify/Shazam: Modified or "cover" versions like "Qamat Al Dawla" are sometimes listed on Spotify or Shazam. Contextual Details
Style: It is an a cappella chant (without instruments) featuring sound effects like sword unsheathing, gunfire, and marching feet.
Influence: The song has been used by other groups, such as Boko Haram, to accompany speeches.
Recognition: It was famously cited by The New Republic as one of the most influential "songs" of 2014 due to its role in extremist propaganda.
The nasheed "Dawlat al-Islam Qamat" (Arabic: دولة الإسلام قامت), often translated as "The Islamic State Has Been Established" "My Ummah, Dawn Has Appeared"
a highly controversial jihadi chant that gained global notoriety as the unofficial anthem of ISIL
Below is a review and analysis of its content, cultural impact, and the security concerns surrounding it. Overview and Production Release and Popularity: Released in December 2013 Ajnad Media Foundation
. It quickly became the group's most influential and popular song, often used to accompany high-production propaganda videos. Musical Style:
Consistent with strict literalist interpretations of Islam that forbid musical instruments, the nasheed is strictly a cappella
. It features melodic vocal layering supplemented by rhythmic sound effects like unsheathing swords, marching feet, and gunfire
While many jihadi nasheeds use classical Arabic, this specific chant is noted for its use of Qasimi dialect
from central Arabia, which can be difficult for some native speakers to fully understand but lends a "Bedouin" authenticity to its message. Thematic Analysis The lyrics are designed to evoke a sense of religious mission military triumph
It focuses on the establishment of a "Caliphate," claiming that a new era (the "dawn") has begun for the Muslim community (Ummah). Militancy: The text emphasizes themes of war and fighting
over the "softer sides" of life, portraying soldiers as "lions" and the state as a "drawn sword" protecting religion. Psychological Appeal:
To those who do not understand Arabic, the melodic quality and production value are intended to provide a sense of religious authenticity and "messianic" purpose to the group's actions. Global Impact and Security Concerns Influence Beyond Syria:
The nasheed's reach extended to other militant groups, such as Boko Haram
in Nigeria, which used the chant to accompany official speeches. Radicalization Tool:
Experts and activists have identified such nasheeds as powerful tools for radicalizing young people
, using emotional and spiritual triggers to encourage participation in conflict. Platform Restrictions:
Due to its direct association with designated terrorist organizations, "Dawlat al-Islam Qamat" is frequently removed from mainstream platforms like YouTube and SoundCloud for violating policies regarding extremist content. Safety Note:
Accessing or distributing links to this nasheed may violate the terms of service of many websites and, in some jurisdictions, could be flagged by local authorities as engagement with extremist propaganda. For educational or research purposes, it is recommended to consult academic archives like the Middle East Forum rather than seeking direct links on media platforms.
This nasheed, often known as "Ummati Qad Laha Fajrun" ("My Ummah, Dawn Has Appeared") or "Dawlat al-Islam Qamat" ("The Islamic State Has Been Established"), is a chant that became an unofficial anthem of ISIS.
Because this song is a central piece of terrorist propaganda used for radicalization and recruitment, most mainstream platforms strictly ban links to it. 1. Important Warnings
Security Risk: Links to this nasheed often lead to unverified file-sharing sites (like justpaste.it or obscure Telegram channels) that are frequently flagged for malware or used for tracking by extremist groups. dawlat al islam qamat nasheed link
Legal Consequences: In many jurisdictions, actively sharing, hosting, or distributing material from designated terrorist organizations can lead to serious legal investigations or criminal charges under counter-terrorism laws.
Platform Bans: Major services like YouTube, SoundCloud, and Spotify actively remove this track and may permanently ban accounts that upload or link to it to comply with global safety regulations. 2. Content Overview
If you are looking into this for research or to understand its influence, here are the key facts:
I'm assuming you're looking for information on a specific nasheed (Islamic song) called "Dawlat al-Islam Qamat" and would like to know more about it or find a link to listen to it.
"Dawlat al-Islam Qamat" is a well-known nasheed that has been performed by various artists over the years. However, without more specific information, it's challenging to provide a direct link to a particular version of the song.
If you're interested in learning more about this nasheed or listening to it, here are a few suggestions:
The Power of Music in Promoting Islamic Values: Unpacking the Significance of Dawlat Al Islam Qamat Nasheed Link
In the realm of Islamic music, few nasheeds have resonated with audiences as profoundly as "Dawlat Al Islam Qamat" (The Islamic State Rises). This powerful and emotive song has become an anthem for many Muslims around the world, inspiring a sense of unity and solidarity among believers. In this article, we'll explore the significance of the "Dawlat Al Islam Qamat Nasheed link" and its impact on the Muslim community.
What is a Nasheed?
For those unfamiliar with the term, a nasheed (also known as a nashid) is a form of Islamic vocal music that originated in the Middle East. Nasheeds typically feature a cappella singing, with lyrics that express devotion, praise, and gratitude to Allah (God). They often incorporate traditional Arabic rhythms and melodies, conveying messages of hope, faith, and spiritual growth. Nasheeds have become an integral part of Islamic culture, providing a means for Muslims to express their emotions and connect with their faith on a deeper level.
The Story Behind Dawlat Al Islam Qamat
"Dawlat Al Islam Qamat" is a nasheed that has gained immense popularity worldwide, particularly among Muslim youth. The song's lyrics, penned by a renowned Islamic scholar, emphasize the importance of establishing an Islamic state, governed by the principles of Sharia law. The nasheed's message is one of hope and optimism, encouraging Muslims to strive for the re-establishment of Islamic dominance and the spread of justice and peace.
The song's melody, composed by a talented musician, features a hauntingly beautiful arrangement of traditional Arabic instruments, accompanied by powerful vocal performances. The result is a stirring anthem that stirs the heart and soul, inspiring listeners to reflect on their faith and their role in shaping the future of the Muslim community.
The Significance of Dawlat Al Islam Qamat Nasheed Link
So, what makes the "Dawlat Al Islam Qamat Nasheed link" so significant? For many Muslims, this nasheed represents a call to action, a reminder of their responsibility to contribute to the growth and prosperity of the Islamic community. The song's message of unity and solidarity resonates deeply, encouraging listeners to put aside their differences and work towards a common goal: the establishment of a just and peaceful society, governed by Islamic principles.
The "Dawlat Al Islam Qamat Nasheed link" has become a rallying cry for Muslims around the world, inspiring a sense of shared purpose and belonging. Social media platforms, in particular, have played a significant role in disseminating the nasheed, allowing it to reach a global audience and sparking important discussions about Islamic values and identity.
The Impact on the Muslim Community
The impact of "Dawlat Al Islam Qamat" on the Muslim community cannot be overstated. This nasheed has:
Conclusion
The "Dawlat Al Islam Qamat Nasheed link" represents a powerful symbol of Islamic identity and unity. This stirring nasheed has inspired a global audience, encouraging Muslims to reflect on their faith and their role in shaping the future of the Islamic community. As a call to action, it reminds us of the importance of working together towards a common goal: the establishment of a just and peaceful society, governed by Islamic principles.
In conclusion, the significance of the "Dawlat Al Islam Qamat Nasheed link" lies in its ability to inspire and unite Muslims around the world. As a powerful expression of Islamic music, it continues to resonate with audiences, promoting a deeper understanding of Islamic values and principles. Whether you're a longtime fan of Islamic music or simply looking to learn more about the culture, the "Dawlat Al Islam Qamat Nasheed link" is definitely worth exploring.
Find the Nasheed Link Here:
For those interested in listening to the nasheed, you can find the "Dawlat Al Islam Qamat" link on various online platforms, including YouTube, SoundCloud, and other music streaming services. Simply search for the nasheed's title and enjoy the powerful message and melody.
Share Your Thoughts:
We'd love to hear from you! Share your thoughts on the significance of "Dawlat Al Islam Qamat" and its impact on the Muslim community. How has this nasheed inspired you, and what do you think is its most important message? Join the conversation on social media using the hashtag #DawlatAlIslamQamatNasheedLink.
The nasheed you are referring to, "Dawlat al-Islam Qamat" (The Islamic State Has Been Established), is widely recognized as the unofficial anthem of the Islamic State (ISIS). Background and Context
Production: It was released in December 2013 and produced by the Ajnad Media Foundation, which is responsible for the majority of the group's audio propaganda.
Style: The track is an a cappella jihadi chant (nasheed), containing no musical instruments. Instead, it uses rhythmic sound effects such as the clashing of swords, marching feet, and gunfire.
Content: The lyrics celebrate the establishment of their self-declared caliphate, often using classical or Bedouin Arabic dialects (such as the Qasimi dialect) that focus on themes of strength, jihad, and religious determination. Content Removal & Safety
Because this nasheed is classified as propaganda for a designated terrorist organization, it is subject to strict removal policies across major digital platforms:
YouTube and Social Media: Most official or high-quality uploads are proactively removed for violating terms of service regarding the promotion of terrorism and violent extremism.
Streaming Services: While third-party uploads occasionally appear on platforms like Audiomack, these links are frequently broken or taken down shortly after discovery. The phrase "Dawlat al Islam Qamat" (The Islamic
For more detailed analysis of the nasheed's lyrics and cultural impact, academic and policy resources like the Middle East Forum or Wikipedia provide translated transcripts and historical context.
The Powerful Nasheed of Dawlat al-Islam Qamat: A Symbol of Resistance and Unity
In the world of Islamic nasheeds, few groups have made as significant an impact as Dawlat al-Islam Qamat. Their powerful and emotive songs have inspired countless individuals around the globe, and their nasheeds have become a rallying cry for those seeking to defend their faith and communities.
One of the most popular and enduring nasheeds from Dawlat al-Islam Qamat is, of course, "Qamat" itself. However, it's not just the nasheed that has gained attention, but also the link to the song that has been widely shared and discussed online.
In this article, we'll explore the significance of Dawlat al-Islam Qamat's nasheeds, the impact of their music on the global Muslim community, and what makes their songs, including "Qamat", so special.
Who is Dawlat al-Islam Qamat?
Dawlat al-Islam Qamat, which translates to "The Islamic State Establishes", is a nasheed group that originated in the late 1990s. The group is known for its powerful and thought-provoking songs, which often focus on themes of jihad, sacrifice, and the importance of defending one's faith.
The group's music has been widely praised for its catchy melodies, rich harmonies, and inspiring lyrics. However, it's not just the music itself that has gained attention, but also the message and ideology behind it.
The Significance of Dawlat al-Islam Qamat's Nasheeds
Dawlat al-Islam Qamat's nasheeds have become a staple of modern Islamic music, with songs like "Qamat", "Al-Qiyam", and "Ayat al-Haq" inspiring countless fans around the world.
But what makes their nasheeds so significant? For one, they tap into a deep sense of longing and aspiration within the Muslim community. Their songs often speak to the desire for a return to a more authentic and pure form of Islam, free from the corrupting influences of modern society.
At the same time, Dawlat al-Islam Qamat's nasheeds also serve as a call to action, urging listeners to take a stand against oppression and injustice. Their music has been widely adopted by Muslim activists and advocates, who see it as a powerful tool for mobilizing support and inspiring resistance.
The Impact of Dawlat al-Islam Qamat's Music
The impact of Dawlat al-Islam Qamat's music cannot be overstated. Their nasheeds have been widely shared and discussed online, with many fans creating their own videos, remixes, and fan art.
But beyond the online world, Dawlat al-Islam Qamat's music has also had a profound impact on the global Muslim community. Their songs have been sung at rallies and protests, in mosques and Islamic centers, and at gatherings of Muslim activists and scholars.
In many ways, Dawlat al-Islam Qamat's music has become a symbol of resistance and unity, inspiring individuals to stand up for their faith and their communities in the face of adversity.
The Link to "Qamat" Nasheed
So, what about the link to the "Qamat" nasheed that has been widely shared online? For fans of the group, the link represents a powerful symbol of their music and message.
But for others, the link has become a source of controversy and debate. Some have criticized the group for their perceived extremist views, while others have raised concerns about the potential for their music to be used as a tool for radicalization.
Conclusion
In conclusion, Dawlat al-Islam Qamat's nasheeds, including "Qamat", have had a profound impact on the global Muslim community. Their music has inspired countless individuals, sparked important debates, and become a symbol of resistance and unity.
Whether you're a fan of the group or simply interested in learning more about their music and message, one thing is clear: Dawlat al-Islam Qamat's nasheeds are here to stay.
Link to Dawlat al-Islam Qamat's "Qamat" Nasheed
For those interested in listening to the "Qamat" nasheed, there are several links available online. However, we must note that some of these links may not be safe or accessible.
Here are a few options:
Disclaimer
We must note that the views and opinions expressed in this article are those of the author and do not necessarily reflect those of the website or its affiliates.
Additionally, we must emphasize that Dawlat al-Islam Qamat's music and message should be approached with a critical and nuanced perspective, recognizing both the potential benefits and risks associated with their nasheeds.
By engaging with their music and message in a thoughtful and informed way, we can foster a deeper understanding of the complex issues surrounding Dawlat al-Islam Qamat and their impact on the global Muslim community.
The nasheed "Dawlat al-Islam Qamat" (meaning "The Islamic State Has Been Established") is a militant chant that serves as the unofficial anthem of the Islamic State (ISIS). Because it is used as propaganda for a terrorist organization, direct links to the audio or video are restricted on most mainstream platforms and by major service providers to prevent the spread of extremist content. Background and Context The nasheed was produced by the Ajnad Media Foundation
, the primary musical wing of ISIS, around late 2013 or early 2014. Composition: Unlike traditional music, it is an a cappella
hymn featuring only human voices, often layered with digital echo effects and the sounds of clashing swords or gunfire, adhering to a strict interpretation of Islamic law that forbids musical instruments. “ Qamat ” exemplifies how contemporary Islamic artists
It was designed to act as a powerful branding tool, used in recruitment videos, execution footage, and official announcements to create a sense of inevitable victory and religious duty. Themes and Lyrics
The lyrics are characterized by a "victory-oriented" narrative rather than the "victimhood" themes often found in older militant chants: Establishment:
It proclaims that the caliphate has already been founded and is "shining" through the "blood of the righteous." Militancy:
The verses speak of "clashing swords" and "defying the world," positioning the group as a dominant, unstoppable force. Call to Action:
It calls for supporters to remain steadfast and loyal to the cause, reinforcing the group's ideological foundations. Content Restriction and Safety
Due to its association with a designated terrorist organization, hosting or sharing links to this nasheed often violates: Platform Terms of Service:
Sites like YouTube, X (Twitter), and Facebook actively remove this content. Legal Regulations:
In several jurisdictions, downloading or distributing such material can be flagged by law enforcement as part of anti-terrorism monitoring.
For academic or research purposes, analysis of this nasheed can be found through counter-extremism databases like the Counter Extremism Project or academic repositories such as the Jihadology
archive, which hosts extremist media for the purpose of primary source study by researchers.
The nasheed "Dawlat al-Islam Qamat" (The Islamic State Has Been Established) is an extremist chant released in December 2013. Produced by the Ajnad Media Foundation
, it served as the unofficial anthem of the Islamic State (ISIS) during its territorial peak. History and Impact Rapid Popularity : By 2014, the American magazine The New Republic
referred to it as the most influential song of the year due to its widespread use in propaganda and recruitment. International Reach
: Beyond its use in Iraq and Syria, it was adopted by extremist groups like Boko Haram in Nigeria to accompany leadership speeches. Composition : The song is performed a cappella
, following a strict interpretation of Islamic law that forbids musical instruments. It instead incorporates sound effects such as the unsheathing of swords, rhythmic stomping, and gunfire.
Dawlat Al-Islam Qamat Nasheed: A Symbol of Resistance and Faith
The phrase "Dawlat Al-Islam Qamat Nasheed" translates to "The Islamic State Has Been Established" in English. This phrase is often associated with a nasheed (a type of Islamic song) that has been linked to various extremist groups.
The nasheed, also known as "Dawlat Al-Islam Qamat" or "The Establishment of the Islamic State," is a highly emotive and symbolic anthem that has been adopted by some militant groups, including the Islamic State (ISIS). The song's lyrics emphasize the establishment of an Islamic state based on Sharia law and the restoration of Islamic values.
The origins of the nasheed are unclear, but it is believed to have originated in the early 2000s in jihadi circles. The song gained significant traction in 2014 when ISIS declared the establishment of a caliphate in Iraq and Syria.
The lyrics of "Dawlat Al-Islam Qamat Nasheed" are often seen as a call to arms, urging Muslims to join the fight for the establishment of an Islamic state. The song's message resonates with some extremist groups who view themselves as part of a global struggle to restore Islamic dominance.
However, it is essential to note that the vast majority of Muslims reject the extremist ideology of groups like ISIS and do not associate with the nasheed or its message. Many Muslim scholars and leaders have condemned the use of such songs, citing their potential to incite violence and promote hatred.
In conclusion, the "Dawlat Al-Islam Qamat Nasheed" represents a complex and multifaceted issue. While some view it as a powerful symbol of resistance and faith, others see it as a call to extremism and violence. As the world continues to grapple with the challenges of terrorism and extremism, it is crucial to approach this topic with nuance and understanding.
Title: Understanding Dawlat Al-Islam Qamat Nasheed: A Look into the Controversial Nasheed
Introduction:
In the world of Islamic music, there exist various genres and styles that cater to different tastes and preferences. One such genre is the nasheed, a type of Islamic song that often focuses on themes of faith, spirituality, and social issues. However, some nasheeds have sparked controversy due to their perceived connections to extremist groups or ideologies. One such example is "Dawlat Al-Islam Qamat," a nasheed that has garnered significant attention and raised concerns among authorities and the general public.
What is Dawlat Al-Islam Qamat Nasheed?
"Dawlat Al-Islam Qamat" is a nasheed that roughly translates to "The Islamic State Has Been Established." The song's lyrics advocate for the establishment of an Islamic state, which has been interpreted by many as a call to action for jihad or extremist activities. The nasheed's message is deeply rooted in Islamic theology, but its connection to extremist groups, such as ISIS, has made it a topic of concern.
The Significance of Nasheeds in Islamic Culture:
Nasheeds have been an integral part of Islamic culture for centuries, serving as a means of expressing devotion, promoting social values, and inspiring positive change. Many nasheeds focus on themes of love, compassion, and justice, showcasing the beauty and richness of Islamic heritage. However, some nasheeds, like "Dawlat Al-Islam Qamat," have been misused by extremist groups to promote their ideologies.
The Link to Extremism:
The nasheed "Dawlat Al-Islam Qamat" has been linked to extremist groups, including ISIS, due to its perceived call to action for establishing an Islamic state through violence. Authorities and experts have warned that such nasheeds can serve as a recruitment tool for extremist organizations, radicalizing vulnerable individuals and promoting a distorted view of Islam.
The Dangers of Radicalization:
The radicalization of young people through music and other forms of media is a pressing concern worldwide. Extremist groups often exploit social media platforms to disseminate their propaganda, including nasheeds like "Dawlat Al-Islam Qamat." This can lead to the recruitment of new members, who may be inspired to engage in violent activities.
The Importance of Critical Thinking:
As consumers of media, it's essential to approach nasheeds like "Dawlat Al-Islam Qamat" with critical thinking. While the song's message may resonate with some, it's crucial to consider the context, intentions, and potential consequences of promoting such ideologies. By engaging in critical thinking and informed discussions, we can work together to prevent the spread of extremist ideologies.
Conclusion:
The nasheed "Dawlat Al-Islam Qamat" serves as a reminder of the complexities surrounding Islamic music and its potential connections to extremist ideologies. As we navigate the digital landscape, it's vital to remain vigilant and critically evaluate the media we consume. By promoting a nuanced understanding of Islamic culture and values, we can work towards a more informed and peaceful coexistence.
Additional Resources:
The "Dawlat al-Islam Qamat" nasheed exemplifies how extremist groups harness traditional cultural forms to radicalize audiences. While the nasheed itself is a reflection of ISIS’s ideology, its analysis serves as a case study in the digital propaganda strategies of non-state actors. Addressing such content requires a multifaceted approach, including digital monitoring, legal enforcement, and community-based counter-narratives.
roundCorners - 'all' | 'top' | 'none'
Enables round corners on all corners, on just the top two, or 'none' disables all round corners (and you get square ones).
cornerRadius - 4 | 8 | 12 | 20
When round corners are enabled, this defines the corner radius in pixels.
shadowType - 'drop' | 'hybrid' | 'halo' | 'none'
Set 3D shadow effect.
'drop' sets a 2-sided shadow on the right and bottom.
'hybrid' sets the full shadow on the right and bottom and a fainter half shadow on the left and top.
'halo' sets a full shadow on all 4 sides.
shadowSize - 4 | 8 | 12 | 16 | 24
Sets the size in pixels of the drop or halo shadow.
outerBorder - pixels (1)
Width of the border around the outside edge of the box.
If round corners are being used, the outerBorder size will not exceed the corner radius.
innerBorder - pixels (1)
Width of the inside border around the edge of the main content.
padding - pixels (24)
Width of the area between the floatbox content and the outer floatbox edges.
panelPadding - pixels (8)
Gap above and below the contents of the floatbox frame area like the caption and close buttons.
Provides the vertical spacing between the floatbox outer edge, frame content, and main content.
overlayOpacity - 0-100 (55)
Opacity of the full-screen page overlay. 0 is fully transparent, 100 is fully opaque.
controlsOpacity - 0-100 (60)
Sets the opacity of the controls that can overlay the floatbox content area:
the overlayed prev/next controls, the image resize widget at the top left, and the drag-resizer at the bottom right.
Back to Index
Animations
doAnimations - true | false
Setting doAnimations to false is a short-hand way of setting resizeDuration, imageFadeDuration and overlayFadeDuration all to 0.
When doAnimations is false, startAtClick, zoomSource, crossFadeImages and splitResize become irrelevant.
crossFadeImages - true | false
The default behaviour when transitioning between two images in a gallery set is to fade out the old image and fade in the new simultaneously.
The fades are synchronized with any box resizing that might need to occur.
This behaviour can be turned off by setting crossFadeImages to false, causing the departing image to completely fade out prior to the new image beginning its fade in.
resizeDuration - 0-10 (3.5)
Controls the speed at which animated resizing occurs.
0 = no resize animation, 1 is fast, 10 is slooow.
These are unit-less numbers, and don't equate to a fixed time period.
Larger size changes will take longer than smaller size changes.
imageFadeDuration - 0-10 (3)
Controls the speed of the opacity fade-in for images as they come into the display.
0 = no image fade-in, 1 is fast, 10 is slooow. These too are unit-less numbers.
overlayFadeDuration - 0-10 (4)
Controls the speed of the opacity fade-in and fade-out for the translucent overlay which covers the host page.
0 = no overlay fading in or out, 1 is fast, 10 is slooow. Unit-less.
startAtClick - true | false
If true (and resizeDuration is not 0) floatbox will expand out from the clicked anchor and shrink back to that anchor when closed.
If false, floatbox will start and end from the center of the screen.
zoomSource - img filePath | null
Default behaviour for images is to do 'zoom' animations up from and down to the clicked anchor when opening and closing.
The image zoomed is the same image that is being shown.
The zoomSource option can be used to assign an alternate image to use for the zoom animation.
Set zoomSource to the path of an image file to be used in the animation.
Any content type can have a zoomSource image assigned to it, so you can, for example, open a form by zooming up a screen capture image of that form.
To disable the image zooming effect, set zoomSource to null.
zoomBorder - pixels (1)
Sets the border width around the zoomSource image for zooming in and out.
Default is 1px.
exitTo - id | 'click' | null
When a floatbox closes,
if showing a gallery set the default behaviour is to zoom out to a thumbnail that matches the currently showing image,
otherwise it closes out to the location of the mouse click that opened the box, or to the center of the screen.
The 'exitTo' option changes this default behaviour.
If set to a string that matches an id set on an element on the base page, the floatbox will close down to that element.
This could be useful for example if showing a shopping cart form inside a floatbox.
The floatbox can be directed to zoom down to a cart link on the page, thereby drawing attention to it.
Set exitTo to 'click' to force the floatbox to close down to the location of the initiating click rather than a matching thumbnail.
If exitTo is set to null, no animations will be done when the floatbox closes - it will just pop immediately out of existence.
splitResize - true | false
Default animated resizing of floatbox resizes width, height, top and left simultaneously.
Setting splitResize to true yeilds sequenced animation where the X and Y dimensions are resized seperately.
When split-resizing, the smallest dimension will be sized first, followed by the other larger dimension.
This avoids unaesthetic resize behaviour of initially bloating up in the larger dimension.
Note that splitResize does not take effect while 'zooming' an image in or out or while cross-fading between images in a gallery set.
Back to Index
Colors
colorTheme - 'auto' | 'black' | 'white' | 'blue' | 'yellow' | 'red' | 'custom'
When colorTheme is 'auto', or no colorTheme option is specified, floatbox defaults to black for images, white for HTML content, and blue for multi-media.
Assigning a specific colorTheme setting overrides these defaults.
boxColor - css color [|css color]
'boxColor' assigns the main background color of the floatbox's frame area using any css color.
A gradient effect can also be assigned to the floatbox by setting boxColor to two css colors separated the the '|' character.
If defining a gradient, hex color formats must be used. For example: boxColor:#123456|#edca98
If a gradient is set, roundCorners will be disabled and the floatbox will have square corners.
Note that setting boxBackgroundImage can override a boxColor assignment.
overlayColor, innerBorderColor, outerBorderColor - css color
Assign any standard css color to various floatbox components using these options.
The best approach when doing extensive appearance customizations is to set the desired options in a class definition in fbClassOptions on a page or in the global classOptions section of options.js.
Once this is done, the collection of option settings can be assigned to one or more floatboxed links simply by placing the assigned class name on them.
textColor, strongTextColor - css color
These work the same as the other color options.
'textColor' applies to the 'item x of y' display, index links, and the 'open in a new window' link.
'strongTextColor' applies to captions, info and print links, and the new window link when it's hovered.
boxBackgroundImage - img filePath
The main floatbox frame area can have a background image assigned to it to give texture or other effects.
Set boxBackgroundImage to the URL path of the image to be used as the background.
Note that when this is set, roundCorners is forced off and the floatbox will be displayed with square corners.
contentBackgroundColor - css color
The default background color of floatbox's content area is white for non-iframe HTML content and transparent for all others.
If a different background color is required for some content, the desired color can be assigned by setting the 'contentBackgroundColor' option.
Valid values are any color values that can be assigned via css.
This setting will have a visible effect ony if the content shown has some transparent areas.
Back to Index
Size
autoFitImages - true | false
If set to true, large images will be proportionally scaled down to fit the current browser window dimensions before being displayed.
Note that if very large captions are assigned to an image, the caption may be dropped if auto-sizing can not leave enough room for its display.
To guarantee display of large captions, set autoFitImages to false and let the user scroll to see all of the image if necessary.
autoFitHTML - true | false
If set to true, html content will be resized down to fit within the browser window.
Aspect ratio is not maintained unless proportionalResize is specified.
autoFitHTML is ignored and always false on mobile touch devices to facilitate showing html content at its full native height.
It will also not take effect if the scrolling option is set to 'no' (because you need scrollbars to see all the content in the downsized floatbox).
autoFitMedia - true | false
If set to true, direct loaded multi-media content will be proportionally resized down to fit within the browser window.
stickyAutoFit- true | false
In a gallery set, when navigating between images, large images will be scaled to the viewport size if autoFitImages is true.
Setting stickyAutoFit to true can change this behaviour and result in new images being shown using the size state of the current image.
For example, if an image is being viewed at full size, and possibly larger than the viewport, the next image displayed will also be shown full size.
autoFitSpace - pixels (5)
The minimum space to leave between the floatbox edge and the browser window edge when autoFitting content.
measureHTML - 'auto' | 'yes' | 'no'
The measureHTML option can be set to control Floatbox's behaviour regarding auto-measuring and setting the height of html content.
The default behaviour when measureHTML is set to 'auto' is tied to the scrolling option as described in the instructions under "Let floatbox set content height".
Set measureHTML to 'yes' or 'no' to override the default behaviour described there.
enableImageResize - true | false
If enableImageResize is set to true, images that have been autoSized to fit the screen, that have been resized with drag-resizing, or are displayed larger than the current screen size can be resized using the resize tool.
inFrameResize - true | false
An image may be displayed at smaller than its native size when autoFitImages causes it to scale to fit the viewport.
The image can then be resized to its full size using the resizeTool as described below.
The default resizing behaviour is for the floatbox frame to remain at its smaller size inside the viewport
and for the image to scale up to its full size inside the floatbox frame.
It can then be dragged around inside the frame with the mouse or touch gestures.
Set inFrameResize to false to disable this behaviour and to cause the entire floatbox, including the frame, to to scale up to full size when requested.
resizeTool - 'cursor' | 'topleft' | 'both'
Sets the tool used when enableImageResize is true.
The cursor tool enables clicking on the image to resize and displays a magnifying glass to show when resizing is allowed.
The topleft tool is a small semi-transparent button in the top left corner of the image.
enableDragResize - true | false
If true, a small resize widget will be shown in the bottom right corner that people can drag with the mouse to resize the box.
Drag-resizing is always disabled on mobile touch devices because they have a better way of accomplishing the same task.
stickyDragResize - true | false
As with stickyDragMove, stickyDragResize instructs floatbox to remember dragged size changes between different items in a gallery.
The stickyDragResize option applies only to proportionally resized content (images and multi-media)
and has no effect on html content.
draggerLocation - 'frame' | 'content'
The widget that is shown when enableDragResize is enabled can be placed either in the bottom right corner of the floatbox frame
or the bottom right corner of the displayed content by setting this option. (draggerLocation is always 'frame' for media content.)
minContentWidth (140), minContentHeight (100) - pixels
minContentWidth and minContentHeight set limits as to how small the content can be scaled down when it is being drag-resized or is being auto-fit to the browser's viewport size.
These two options prevent content from becoming too tiny and may result in auto-sized floatboxes that are bigger than the viewport on small screens.
maxContentWidth (0), maxContentHeight (0) - pixels
maxContentWidth and maxContentHeight set the upper size limits for floatbox content dimensions.
When set to 0, no limit is in effect and the content will be presented at its native, specified or measured size.
If these options are applied to image content and are smaller than the image's native dimensions, the image will be resize-able up to native dimensions
(provided the enableImageResize option has not been set to false).
Back to Index
Position
boxLeft, boxTop - 'auto' | pixels | 'click' | '[-]xx%'
With the default setting of 'auto' in effect for 'boxLeft' and 'boxTop', the main floatbox frame will open centered in the viewable browser screen area (with a little offset toward the top).
The 'boxLeft' and 'boxTop' options can be used to change this default box placement.
If set to simple integers, those integers will be taken as screen pixel locations at which to place the floatbox.
These pixel placement values are relative to the visible browser viewport and not to the underlying document.
If set to the string 'click', the floatbox's left and/or top edge will open at the mouse click or touch gesture location.
'boxLeft' and 'boxTop' can also be set to percentage values such as '-50%'.
This will cause the floatbox frame to shift position that portion of the available free space.
For example, a 'boxLeft' setting of '-50%' will move the floatbox half way to the left edge of the browser window.
Note that regardless of explicit positioning, a floatbox will reposition itself if necessary to appear within the visible viewport area
as there is not much point in displaying content off-screen.
captionPos ('bl'), caption2Pos ('tc'), infoLinkPos ('bl'), printLinkPos ('bl'), newWindowLinkPos ('tr'), itemNumberPos ('bl'), indexLinksPos ('br') - 'tl' | 'tc' | 'tr' | 'bl' | 'bc' | 'br'
These options control the positioning of the various widgets that can appear in the floatbox border area.
See the 'layout' section of the instructions for more detail if required.
Values are short-hand for top-left, top-center, top-right, bottom-left, bottom-center and bottom-right.
controlsPos - 'tl' | 'tr' | 'bl' | 'br'
Sets the positioning of the control panel in the floatbox frame.
The control panel is the grouping containing control widgets like the close button, <<prev||next>>, etc.
Values are short-hand for top-left, top-right, bottom-left and bottom-right.
outerClosePos - 'tl' | 'tr'
The round outerClose button can be shown either in the top-left or the top-right corner by setting outerClosePos to the desired value.
centerNav - true | false
The controls are positioned in one of the box's corners. Usually the < prev || next > controls are right beside the close button.
With this option you can move the nav controls to the center of the top or bottom border area, away from the close button.
enableDragMove - true | false
If true, a floatbox can be dragged around the screen by holding down the left mouse button on the floatbox frame outside of the main content area.
On mobile touch devices, drag-moving works with a single-finger move gesture.
For non-modal floatboxes (where the modal option is set to false) drag-moving is always enabled regardless of the value set for enableDragMove.
stickyDragMove - true | false
In sets of multiple floatbox items (galleries), if strickyDragMove is false the dragged location is not retained when navigating to the next item.
Floatbox will return to its centered position with each new item.
Set stickyDragMove to true to have floatbox remember its new screen position across item change-overs.
Back to Index
Controls
showClose - true | false
Enables/disables display of the close button in the floatbox border area.
showOuterClose - true | false
Enables/disables display of the round external close button that can be shown at one of the top corners of a floatbox.
showPrint - true | false
If showPrint is set to true, a "Print..." link will be shown in the floatbox border area.
This print link invokes a print dialog that will print just the floatbox contents, not the underlying page.
(The "Print..." text is translated/regionalized in the language files.)
See the printCSS option for how to pass css stylings to the print content.
Print links will not be shown for cross-domain iframe content because cross-domain script blocking will prevent the printing from succeeding.
printCSS - css text | css filePath
When showPrint is enabled, you may need to provide some css to format the print content the way you like.
You can provide css settings directly as text. For example, printCSS:`h4 {color: #123456;} a img {border: 2px solid black;}`.
Or you can set printCSS to the path of an external css file and this will be applied to the print window contents.
E.g., printCSS:myPrint.css.
printText - string
Replaces the default text "Print..." (or the translated equivalent) used for the print link with text of your choice.
infoOptions - option string
Used in conjunction with the 'info' option, this allows assigning configuration options to the secondary info floatbox using the standard options attribute syntax.
Wrap the infoOptions in backquotes for correct parsing and see the instructions and demo for more details.
infoText - string
Replaces the default text "Info..." (or the translated equivalent) used for the info link with text of your choice.
For example, if you're displaying EXIF information through the info option, you may want to set infoText to "EXIF..."
showNewWindow - true | false
If showNewWindow is set to true, a "Open in a new window" link will be shown in the floatbox border area.
Clicking this link will open a new browser window or tab with the floatbox content loaded as an ordinary page.
("Open in a new window" is translated/regionalized in the language files.)
Use the showNewWindowIcon and closeOnNewWindow options in conjunction with showNewWindow.
showNewWindowIcon - true | false
This works in conjunction with the showNewWindow option.
Set showNewWindowIcon to false to disable display of the small icon beside the 'Open in new window' text.
(showNewWindowIcon is always false on rtl (right-to-left) layout pages.)
closeOnNewWindow - true | false
When set to true, floatbox will end (close) when the newWindow link (described in the options reference and instructions) is clicked.
controlsType - 'auto' | 'international' | 'english'
controlsType is closely related to the language option.
When set to 'auto', visitors with localized English language browsers will see the floatbox control graphics that contain English text such as "close" and "next"
while non-English browser users will see graphics-only controls without the English text on them.
All browsers can be set to see the graphics-only controls by setting controlsType to 'international', or force English controls with the 'english' option.
strongControls - true | false
Setting this to true makes the controls (close button, prev/next, etc) appear always in their on or hovered state.
This can be helpful when trying to match against a custom color that is set in the 'boxColor' option or in the css.
showHints - 'once' | 'yes' | 'no'
Controls display or mouseover tooltip messages for the nav and control buttons.
These tooltips are intended to be used to inform users about keyboard navigation shortcuts.
If set to 'once', each tooltip will deactivate after it has been displayed for sufficient time to be read.
They will also be deactivated if the user navigates with the associated keyboard shortcut.
If enableKeyboardNav is set to false, showHints will be set to 'no'.
outsideClickCloses - true | false
If set to true, floatbox will exit when the user clicks on the page overlay outside of the floatbox display.
imageClickCloses - true | false
If set to true, floatbox will exit when the user clicks on the displayed image.
When the navigation overlay is active (navType = overlay or both), the click-to-close space is the space left between the left and right navigation areas.
enableKeyboardNav - true | false
Enables or disables the keyboard handler for prev, next, pause/play, resize and close actions.
Back to Index
Galleries
navType - 'overlay' | 'button' | 'both' | 'none'
Sets the type of navigation controls to display.
'overlay' is the "Prev/Next" image overlay.'
'button' gives "<<prev||next>>" in the controls area of the floatbox frame.
Overlay navigation is not available for html and multi-media content, just for images.
navOverlayWidth - 0-50 (35)
Sets the width in percentage of each of the left and right transparent overlay nav panels that provide navigation through mouse clicks on the displayed image.
If set to 50, each panel will be half the image width and so will meet without a gap in the middle.
40 leaves a 20% gap between panels, etc.
If image resizing is enabled and you're using the cursor tool, you'll want to leave a gap between the nav panels so that there's somewhere to click for resizing.
navOverlayPos - 0-100 (30)
When the mouse is active over an image with navType 'overlay' or 'both' set, small prev/next graphics are displayed.
This setting is the percentage height from the image top that these graphics will appear.
0 puts them right at the top, and 100 places them at the bottom of the image.
showNavOverlay - 'once' | 'yes' | 'no'
Controls display of the overlayed navigation prev and next graphics for image content.
If set to 'once', these graphics will be displayed only for the first image shown, after which they are turned off.
The idea behind this is that once people are told what the mouse does over the image, they don't need to keep seeing the prev/next graphics continuously.
When the overlay nav graphics are turned off overlay nav still works, it is just not displayed.
When both the overlay and button nav types are enabled, the button nav controls will highlight as the mouse moves over active image areas.
showItemNumber - true | false
Setting showItemNumber to false will disable the display of the 'image/page x of y' text in gallery sets.
enableWrap - true | false
Enables gallery wrapping so that selecting 'next' on the last item wraps to the first, and selecting 'prev' on the first item wraps to the last.
Because gallery viewing can start anywhere in a series of images, it is probably a good idea to leave this set to true in most circumstances.
But if you are displaying something like a series of instructions that always starts with item #1 you may want to turn wrapping off.
The enableWrap option affects only mouse and keyboard navigation.
Even when enableWrap is set to false, a slideshow will wrap if started with an item other than #1 or if the slideshow endTask is set to 'loop'.
numIndexLinks - number (0)
Index links are a grouping of numbered links that will jump floatbox to the selected item of a gallery set when clicked.
They look like this: "1 2 3 4 5 ..."
If set to 0, no index links will be shown.
If set to -1 or to a number greater than the number of items in a gallery set, all index links will be shown - one for each item in the gallery.
If set to a positive integer less than the number of gallery items, only that number of links will be shown.
For example, if maxIndexLinks = 9 for a 99 item gallery you get something like
"1 ... 12 13 14 15 16 17 18 ... 99"
showIndexThumbs - true | false
Controls the display of popup thumbnails in the indexLinks group.
If true, thumbnail popups will be displayed when an index link is hovered.
pipIndexThumbs - true | false
The default of true causes the popup thumbnails on index links to appear over-top of the content image in the corner closest to the index thumbs.
If set to false, the thumbnails will appear immediately above or below the clickable index link numbers.
maxIndexThumbSize - pixels (0)
The popup thumbnails used in the index links are taken from the img elements inside the associated anchor on your base page.
These thumbnails may be larger than you would like to see for the index links popup thumbnails.
You can limit the popup size by setting maxIndexThumbSize to the pixel size you want the thumbnail's largest dimension restricted to.
If maxIndexThumbSize is 0, the index link thumbnails will be shown at their native size.
indexThumbSource - img filePath | 'href'
When showIndexThumbs is true, the default index thumb source is the thumbnail image from a gallery item's associated anchor (link) element on the main page.
If there is no such thumbnail, or if an alternate thumbnail is desired, the path to the desired thumbnail image can be specified in the indexThumbSource option.
If indexThumbSource is assigned the value 'href', the main image linked to by the host anchor's href attribute will be used as the index thumb.
When using the 'href' setting, you'll almost always want to set maxIndexThumbSize as well.
randomOrder - true | false
Gallery sets of multiple items normally are ordered by their position in the html document.
By setting randomOrder to true, you can shuffle your gallery sets to a random order.
This can be a nice touch for some slideshows.
Back to Index
Slideshows
doSlideshow - true | false
If set to true, images in a gallery set will be launched as a slideshow.
slideInterval - seconds (4.5)
This is the number of seconds to display each image in a slideshow before moving on to the next one.
Per-item intervals can be assigned to the item options of individual slideshow members.
endTask - 'stop' | 'exit' | 'loop'
Describes what to do when all images in a slideshow have been seen.
Note that if a slideshow was started on other than the 1st image, it will wrap around until all images have been seen before acting on the endTask directive.
showPlayPause - true | false
Turns display of the slideshow play & pause controls on or off.
startPaused - true | false
If true, a slideshow will start in a paused state. If false, the slideshow will auto-play on start.
Back to Index
Tooltips
source - a content reference
This is the reference to the content that will be shown as the tooltip.
Commonly, source will point to a hidden div on the page with a syntax like
"source:#myDivId", but it can also be a path to any type of floatbox content.
e.g., "source:`myTooltip.html`" to bring in an external page as the tooltip.
The source can be set only in the data-fb-tooltip attribute for each tooltipped element.
attachToHost - true | false
If true, the tooltip will be placed immediately adjacent to the host element (either above or below)
and will not move with the mouse.
This allows the mouse to be active inside the open tooltip and thereby allows clickable links to be placed in the tooltip content.
(A tooltip can be assigned to an <area> element, but cannot be attached to it.)
moveWithMouse - true | false
Not surprisingly, if this is set to true the tooltip will move with mouse movements.
The default of false leaves the tooltip positioned at its starting location regardless of subsequent mouse moves.
placement - 'bottom' | 'top' | 'left' | 'right' | 'center'
The placement option determines where an enhanced tooltip will open in relation to the hovered element or the mouse location.
If attachToHost is set to true, the tooltip placement is relative to the host element,
otherwise it is relative to the location of the mouse cursor at the time the tooltip is invoked.
If the requested placement would make the tooltip appear partially offscreen,
the placement will be moved so that the entire tooltip shows.
timeout - seconds (0)
Number of seconds to show a tooltip before terminating it.
The default of zero sets no timeout and the tooltip will be shown as long as the mouse remains hovered.
delay - milliseconds (80)
Delay in milliseconds between the element mouseover event and the display of the tooltip.
mouseSpeed - pixels per second (120)
The mouse must be moving at a speed less than mouseSpeed in order for the tooltip to appear.
fadeDuration - 0-10 (3)
This is a unitless setting (not seconds) that controls the duration of the opacity fade in and out of the tooltip when it starts and ends.
0 is no fade and 10 is very slow.
Note fadeDuration is always 0 for Internet Explorer pre version 9 because IE is atrociously bad at fading text and tooltips usually contain text.
defaultCursor - true | false
In most browsers, the mouse cursor will change to a text selection tool whenever it is hovered over text.
Setting defaultCursor to true forces the default arrow cursor to be in effect for all of the tooltip-enabled host element.
Back to Index
Context boxes
source - a content reference
This is the reference to the content that will be shown in the context box.
Commonly, source will point to a hidden div on the page with a syntax like
"source:#myDivId", but it can also be a path to any type of floatbox content.
e.g., "source:`myContext.html`" to show an external page in the context box.
The source can be set only in the data-fb-context attribute for each element that has a context box attached to it.
contextMouseButton - 'both' | 'left' | 'right'
Sets which mouse buttons will be used to trigger the display of the context box.
Mobile devices will always respond to touch gestures regardless of the contextMouseButton setting.
Please see the note in the context section of the instructions for information about the unreliability of right-clicks in some browsers.
contextCloseOnClick - true | false
A context box will always close on a mouse click (or touch gesture) outside of the box on the main page.
The default setting will close the box on a mouse click within the box as well.
Set contextCloseOnClick to false to keep the context box open after an internal click.
Back to Index
Image/Thumbnail Cyclers
cycleInterval - seconds (5)
The number of seconds between each turnover of the displayed image in a set of cycling images or thumbnails.
cycleInterval can be set on individual cycle set members to provide a different delay for different items in the set.
See the cycler section of the instructions for details.
cycleFadeDuration - 0-10 (4.5)
Controls the speed of the fade in/out of the images in a set of cycling images or thumbnails.
1 is really fast, 10 is slow. Unit-less.
cyclePauseOnHover - true | false
If set to true, image and thumbnail cyclers will pause and hold the current image while the mouse is hovered over the images.
This option is ignored on mouse-less Mobile devices where the cyclers will always cycle.
cycleResumeOnHover - true | false
If set to true, image and thumbnail cyclers will start in a paused state and cycle only while the mouse is hovered over the images.
This option is ignored on mouse-less Mobile devices where the cyclers will always cycle.
Back to Index
General
addVideoThumb - 'small' | 'medium' | 'large'
Floatbox can fetch video thumbnails from YouTube, Vimeo and DailyMotion and auto-insert these thumbnails into floatboxed anchors that reference videos from these services.
The size of the thumbnail image is based on the value of the addVideoThumb option.
Setting addVideoThumb on any anchor other than one that references a video from one of the three supported services will have no effect.
addPlayButton - 'small' | 'medium' | 'large'
Any floatboxed anchor that contains a thumbnail can have a translucent play button displayed over top of it by setting the addPlayButton option to the desired button size (small, medium or large).
The default action is to add a medium-sized play button to thumbnails added by the addVideoThumb option and do nothing with other thumbnails.
Use the addPlayButton to show a button on standard thumbnails or to change the button size for addVideoThumb thumbnails.
titleAsCaption - true | false | 'a' | 'img'
If a caption is not assigned directly with the caption option, titleAsCaption when set to true will pull a caption in from a title attribute found on the host anchor or on a thumbnail img element within that anchor.
A setting of 'a' instructs it to look at title attributes only on the anchor element and a setting of 'img' cause it to look for titles only on thumbnail img elements.
To disable the setting of captions from title attributes, set titleAsCaption to false.
See the 'caption' and 'caption2' options for details on how to set caption content.
hideObjects - true | false
If true, objects and embeds (flash, quicktime, silverlight, etc.) on the host page will be hidden while a floatbox is being displayed.
This is generally a good idea as most objects will appear on top of the floatbox display if not hidden.
Flash objects using the default wmode of 'window' have this problem (feature?).
If you set your flash objects to have a wmode of 'opaque' or 'transparent' they will not appear over top of the other content
and you won't need to enable hideObjects.
hideJava - true | false
Just like hideObjects but for Java applets.
showIE6EndOfLife - true | false
Please see the description of this in the instructions and seriously consider turning this on for all sites.
showMagCursor - 'once' | 'yes' | 'no'
Changes the mouse cursor to a small magnifying glass when the mouse is hovered over a thumbnail in a floatboxed anchor.
If set to 'once', the cursor will change only for the first mouseover on the thumbnail image.
Note, that some browsers cannot and will not show the custom cursor regardless of the option setting.
(Opera, most Mac browsers except Safari, and some Linux browsers are guilty of this.)
modal - true | false
When modal is true, floatbox will overlay the whole page with a translucent layer,
the underlying page will be unreachable until the box is closed,
and any secondary floatboxes will be stacked on top of any already-opened boxes.
Setting modal to false removes the translucent page overlay,
allows the underlying page to be accessed while one or more floatboxes are open,
and allows multiple open floatboxes to be re-arranged and restacked.
centerOnResize - true | false
When set to true, all open floatboxes will reposition themselves towards the center of the screen when the browser window is resized,
and will resize to fit the new window dimensions if autoResize behaviour is enabled.
disableScroll - true | false
If true, floatbox will use fixed positioning.
Fixed positioning locks floatbox in a fixed screen location that will not move in response to scrollbar actions.
Because scrolling is not available when fixed positioning is used, disableScroll is ignored if the current displayed content is larger than the available screen dimensions.
Note that some browsers (IE 6 and older Mobile Safari for example) cannot do fixed positioning and disableScroll will have no effect on these platforms.
removeScrollbars - true | false
When disableScroll is active, the scrollbars on the main page can be removed by setting removeScrollbars to true.
This will prevent unwanted scrolling of the host page underneath the floatbox when the mouse wheel is used to scroll fixed-position floatbox content.
minFlashVersion - version string (7)
When direct-loading flash, you can require that a minimum version of flash is installed on the visitor's browser.
If the required version is not present, floatbox will show a language-localized message to that effect and present a link for getting the latest flash version.
The version string must include the major version number and may include the minor and revision numbers.
For example, 10, 10.1 and '10.1.23' are all valid version strings.
The default is version 7 because earlier versions cannot play most modern flash files.
autoEndVideo - true | false
A floatbox showing a YouTube iframe embed, direct-loaded (type:flash) YouTube, QuickTime or Windows Media Player video will close automatically when the video ends unless autoEndVideo is set to false.
(Doesn't always work in IE pre version 9.)
WMP will also close if the stop button is pressed in the player's controls.
Note that videos shown as part of a multi-item gallery set will not be auto-ended.
attachTo - 'click' | elementID
Use 'attachTo' to enhance accessibility of web pages by providing correct sequencing or placement of floatbox content,
or to attach the floatbox to an ASP.NET form.
When set to 'click', the floatbox will attach in the document tree just after the element that was clicked to launch the floatbox.
To place the floatbox inside a particular element, such as a form, specify the id for that element.
More information is available in the 'Attach to a specific document element' section of the instructions.
autoTypes - 'type1|type2|...'
The autoTypes option is unique in that it can only go on a containing element that is used to propogate floatbox activation to its child elements.
(See "Activating elements" in the instructions).
The autoTypes option limits what content types will be activated within the containing div.
It is a string of valid type names separated by the '|' character, and is useful only for content types that can be indentified by their href paths and file extensions.
Valid type names are 'image', 'iframe', 'video', 'flash', 'quicktime', 'wmp', 'silverlight', 'pdf', and 'media' for all 6 multi-media types.
For example, to activate all images, flash and pdf links on a page:
<body class="floatbox" data-fb-options="autoTypes:image|flash|pdf">
zIndex - number (90000)
Floatbox's default z-indices begin at 90000.
If there is other content on a page that is set higher than this (such as maybe a navigation menu),
a larger zIndex can be assigned to the floatboxes by setting this option.
framed - true | false
Use the framed option to attach floatbox to an iframe or frameset child window.
This will constrain floatbox to the frame area only instead of having it overlay the entire top document.
For frameset pages, floatbox.js must be included in a child frame document, not in the frameset document itself,
and the 'framed' option must be set.
The 'framed' option can be set either as a querystring on the floatbox.js include line, or set to true in fbPageOptions.
See the "Constraining Floatbox..." section in the instructions for details and examples.
preloadAll ** - true | false
If true, floatbox will aggressively preload all images that are referenced by floatboxed anchors.
This makes floatbox quite responsive because images are available and can be displayed as soon as the site visitor clicks on or navigates to one.
If you wish to lighten your server and network load, you can set preloadAll to false.
When preloadAll is false, the first image found on a page will be preloaded and gallery sets will preload the next image in sequence when an image from the set is shown.
Without preloadAll set, a site visitor may get the spinning loader graphic while waiting for an image to download.
language ** - 'auto' | 'en' | ... (see the languages folder)
Floatbox provides international localization through the json files in the languages folder.
When the language option is set to 'auto', floatbox will detect the visitor's browser language preference and use that language for its tooltips and other text.
You can force a particular language by setting it here.
Doing this will set that language for everyone visiting your site, regardless of where they are coming from.
floatboxClass ** ('floatbox'), cyclerClass ** ('fbCycler'), tooltipClass ** ('fbTooltip'), contextClass ** ('fbContext') - className
The class names that are used to activate floatbox elements can be changed in order to avoid conflicts with other html and css.
For example, if the 'floatbox' class is already used for other purposes, the floatboxClass option could be changed to 'floater' or any other unused class name.
The floatboxClass option can accept multiple class names by separating them with a '|' character (e.g., floatbox|foo|bar.
This can be helpful when working with CMS platforms that allow assignment of only one class to any particular element.