Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
114 changes: 62 additions & 52 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,72 +7,82 @@ The plugin should work in IE8 and above as well as in Chrome, Safari and Firefox

You can download split-pane.js and split-pane.css manually to you project or you can install with bower:

bower install split-pane
```
bower install split-pane
```

Split panes are initiated with

$(selector).splitPane();
```js
$(selector).splitPane();
```

Split pane component min-height and min-width are supported, and the component size
can be set programmatically with

$(selector).splitPane('firstComponentSize', 0);"
```js
$(selector).splitPane('firstComponentSize', 0);"
```

or

$(selector).splitPane('lastComponentSize', 100);"
```js
$(selector).splitPane('lastComponentSize', 100);"
```

Only pixel values are supported.

Below is a basic example on how to use the plugin. Check out my [blog post](http://www.dreamchain.com/split-pane/) for some prettier examples.

You need to set up component widths and divider position using css, not as options to the JS splitPane function. The reason for this is that I like things to look good even **before** the JavaScript kicks in.

<!DOCTYPE html>
<html>
<head>
<title>Basic Example</title>
<link rel="stylesheet" href="split-pane.css" />
<script src="http://code.jquery.com/jquery-1.9.1.js"></script>
<script src="split-pane.js"></script>
<style type="text/css">
html, body {
height: 100%;
min-height: 100%;
margin: 0;
padding: 0;
}
.split-pane-divider {
background: #aaa;
}
#left-component {
width: 20em;
}
#my-divider {
left: 20em; /* Same as left component width */
width: 5px;
}
#right-component {
left: 20em; /* Same as left component width */
margin-left: 5px; /* Same as divider width */
}
</style>
<script>
$(function() {
$('div.split-pane').splitPane();
});
</script>
</head>
<body>
<div class="split-pane fixed-left">
<div class="split-pane-component" id="left-component">
This is the left component
</div>
<div class="split-pane-divider" id="my-divider"></div>
<div class="split-pane-component" id="right-component">
This is the right component
<button onclick="$('div.split-pane').splitPane('firstComponentSize', 0);">Collapse first component</button>
</div>
</div>
</body>
</html>
```html
<!DOCTYPE html>
<html>
<head>
<title>Basic Example</title>
<link rel="stylesheet" href="split-pane.css" />
<script src="http://code.jquery.com/jquery-1.9.1.js"></script>
<script src="split-pane.js"></script>
<style type="text/css">
html, body {
height: 100%;
min-height: 100%;
margin: 0;
padding: 0;
}
.split-pane-divider {
background: #aaa;
}
#left-component {
width: 20em;
}
#my-divider {
left: 20em; /* Same as left component width */
width: 5px;
}
#right-component {
left: 20em; /* Same as left component width */
margin-left: 5px; /* Same as divider width */
}
</style>
<script>
$(function() {
$('div.split-pane').splitPane();
});
</script>
</head>
<body>
<div class="split-pane fixed-left">
<div class="split-pane-component" id="left-component">
This is the left component
</div>
<div class="split-pane-divider" id="my-divider"></div>
<div class="split-pane-component" id="right-component">
This is the right component
<button onclick="$('div.split-pane').splitPane('firstComponentSize', 0);">Collapse first component</button>
</div>
</div>
</body>
</html>
```